chore(agents): ecosystem consistency pass to v1.2.2#5
Merged
Conversation
Systematic consistency/quality pass across all 22 agent definitions, the
template spec, the README, and the landing page. Addresses every finding
from the agents/ review:
1. webfetch — declare explicit `webfetch:` permission in every agent
(performance-optimizer and accessibility-expert were missing it).
2/3. version — unify the whole ecosystem on a single version (1.2.2).
Fixes 3-layer drift: agent H1 headers (many said v1.0) vs. footers
(1.2.0/1.0.0) vs. README header (1.2.1) vs. README §13 (1.2.0).
4. Limitations — add a `## Limitations` section to every agent that
lacked one (architect, developer, devops, docs, engineering-team,
reviewer, tester, fact-check, executive-summarizer, jira-writer, kai)
and give research a real agent-level section (it previously only had
an in-template "Gaps & Limitations" inside a code block).
5. tester — de-duplicate the TypeScript linter-config section; keep the
full PHASE 4 appendix and cross-reference it from Best Practices.
6. lint guard — add tests/check_agents.sh (deny-list completeness,
webfetch declared, footer/H1 version == README, Limitations present);
wire it into `make lint-agents` / `test-preflight`. README §13
rewritten to make single-ecosystem-version enforcement explicit.
8. doc-fixer & quick-reviewer — add a 5th Core Principle ("know your
limits / escalate").
9. doc-fixer & quick-reviewer — rename non-standard escalation headings
to the spec's "When to Escalate".
10. research & fact-check — document the write-scoping convention
(single REPORT_/VERDICT_ report file) as a frontmatter comment.
11. TEMPLATE — clarify that Performance-Targets timings/SLAs are typical
targets, not hard guarantees.
12. TEMPLATE — fix duplicate version-history dates (1.0 → 2026-02-10,
confirmed from git history), add a 1.2.2 row, and align the doc's
own H1/footer versions.
Landing page (docs/intro.html) and README installer examples bumped to
1.2.2; the team grid and "20+ agents" copy were already accurate.
Deferred (won't-fix, with rationale): trimming inline boilerplate in
docs/devops — it is valuable reference material, not a defect.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A systematic consistency and quality pass across all 22 agent definitions, the template spec (
TEMPLATE.md), theREADME.md, and the landing page (docs/). Each finding from theagents/review is addressed below, plus a new automated lint guard so this drift can't silently return.A new
make lint-agentstarget validates every agent on each preflight run.Findings addressed
webfetch:permissionperformance-optimizer&accessibility-expert(every agent now declares it)## Limitationssectionsresearcha real agent-level section (previously only an in-template one inside a code block)testertests/check_agents.sh+make lint-agents, wired intotest-preflight; rewrote README §13 to enforce single-ecosystem-versiondoc-fixer&quick-reviewerwrite: trueinresearch/fact-checkTEMPLATE.mdthat timings/SLAs are typical targets, not guaranteesTEMPLATE.md1.0 → 2026-02-10(confirmed via git history), added a1.2.2row, aligned the doc's own H1/footerLanding page & README
docs/intro.html: page title and installer-demo terminal bumped tov1.2.2.README.md: header version→ 1.2.2, installer examples→ v1.2.2, §13 rewritten.kai+engineering-team= 22) — left as-is.Deferred (won't-fix, with rationale)
Trimming the inline boilerplate in
docs/devops— it's valuable reference material for those agents, not a defect.Verification
🤖 Generated with Claude Code